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Foreward 


The  following  document  is  intended  to  provide  keymaps  for  connecting  to  various  hosts  most  effectively 
with  the  least  amount  of  effort  or  memorization  required  by  the  user.  The  original  goal  of  providing  all 
keyboards'  appearance  to  be  uniform  with  respect  to  the  main  F1-F12  keys  on  the  PC  ( i.e.,  IBM's  FI  = 
VAX's  F1=UNIX  Fl=  PC  keyboard  FI)  is  not  possible.  Persoft  allows  softkey  definitions  for  a  limited 
amount  of  keys.  For  instance,  the  Xyplex  maps  NUM  1  of  the  VT220  keyboard  to  the  FI  key  of  the  IBM 
3278-2  keyboard  and  SmarTerm  320  cannot  map  the  PC  keyboard's  FI  key  to  NUM  1. 

However,  ST320  provides  a  help  screen  to  show  all  of  the  translations  without  disrupting  the  connection. 
For  the  vast  majority  of  the  users  at  McClellan  AFB,  PC  with  SmarTerm  or  Window's  terminal  should  be 
effective  and  easy  to  use  for  the  current  applications  on  IBM,  VAX  and  UNIX  hosts. 
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OVERVIEW: 


The  following  keymap  charts  are  intended  to  provide  the  means  to  use  a  PC  with  either  Persoft,  Inc.'s 
SmarTerm  320  communications  software  or  alternatively  Microsoft  Windows  3.1  (V/indows)  TERMINAL 
communication  feature  to  connect  and  perform  applications  on  host  UNIX,  IBM  3090,  and  DEC  VAX 
systems  via  a  Xyplex  TCP/IP  /LAT  terminal  server.  Users  are  encourage  to  use  SmarTerm  320  whenever 
possible  as  this  package  offers  better  capabilities  than  Windows’  TERMINAL  communications  software. 
Users  of  this  document  are  assumed  to  know  installation,  configuration  and  operational  procedures  of  the 
PCs,  Xyplex,  and  various  host  systems  and  their  respective  applications.  The  users  of  these  keymap  charts 
are  intended  to  be  those  users  who  cannot  otherwise  connect  directly  to  the  ethemet  using  Frontier 's 
SuperTCP  TCP/IP  kernel  for  direct  connection  from  PC  to  host. 

There  are  6  combinations  of  HOST-to-Terminal  keymaps: 

1.  PC  with  SmarTerm320  to  3090  IBM  using  TCP/IP  (Tn3270)  protocol 

2.  PC  with  SmarTerm320  to  VAX  using  LAT  protocol 

3.  PC  with  SmarTerm320  to  UNIX  host  using  TCP/IP  protocol 

4.  PC  with  Windows'  Terminal  to  3090  IBM  using  TCP/IP  (Tn3270)  protocol 

5.  PC  with  Windows'  Terminal  to  VAX  using  LAT  protocol 

6.  PC  with  Windows'  Terminal  to  UNIX  using  TCP/IP  protocol 

The  Xyplex  terminal  server  functions  as  a  data  converter  device  .  On  one  side  of  the  Xyplex  is 
asynchronous  data  from  the  PC 's  serial  port ;  the  other  side  is  ethemet  data  encapsulating  the  TCP/IP  or 
LAT  protocols  used  to  make  connections  to  the  host.  Once  established,  the  keyboard  will  be  the  means  to 
communicate  from  the  PC  to  the  host.  Since  the  PC  keyboard  is  different  then  those  keyboards  like  a  tme 
VT320  or  IBM3278  keyboard,  key  maps  are  provided  to  provide  a  relationship  between  the  two  so  the  PC 
keyboard  can  communicate  with  the  host.  The  following  key  map  conversion  charts  are  for  SmarTerm  320 
and  Windows  Terminal  VTIOO  to  establish  VMS,  UNIX,  and  IBM  mainframe  connections .  See  Fig.  A 


Figure  A. 

System  diagram  showing  PC ,  Xyplex  terminal  server,  and  host  computers. 
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1.  PC  with  SmarTerm  320  connected  to  IBIVI 3090 


IBM  3090  (Tn3270) 

PC  (ST320) 

PFl 

NIJM  I 

PF2 

NUM2 

PFl 

NUM3 

PF4 

NUM4 

PF5 

NIJM  5 

PF6 

NUM6 

PF7 

NUM7 

PF8 

NUM8 

PF9 

NUM9 

PFIO 

FI 

PFll 

_ E2 

EE12 _ 

_ E2 

Note: 

Upon  calling  up  TSO  or  CICP  application  on  SCDOl.  MCCLELLAN.  AFMIL,  change  parameter  setting  for 
the  keyboard  to  reflect  12  PF  keys.  Type  <  CNTRL  >  <x>  to  reveal  all  of  the  3278-2  keyboard  to  PC 
keyboard  translations  with  ''in-session'*  help  provided  withXyplex  1600. 
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3.  PC  with  SmarTerm320  connected  to  UNIX  host 


UNIX 

PCfST320I 

FI 

F2 

F3 

F3 

F4 

F4 

F5 

F5 

F6 

F6 

F7 

F7 

F8 

F8 

F9 

F9 

FIO 

FIO 

Fll 

_ AItJFI 

F12 

Alt.F2 

F13 

Alt  F3. 

F14 

AltF4 

F15 

AJLEi 

Eli _ 

Alt  F6 

Note:  Initial  logon  to  a  UNIX  host  like  USS.MCCLELLAN.AF.MIL  will  figure  what  the  remote  terminal 
type  is  and  alert  the  key  translations.  Generally,  most  UNIX  applications  will  work  with  most  VT  type 
terminals  or  terminal  emulators  and  provide  the  translation  at  the  host  itself.  Upon  connection  to  USS,  the 
PC  display  will  indicate  USS's  negotiation  ofSmarTerm  320  emulating  VT320  terminal. 

For  FI2  thru  FI  6  follow  the  steps  below  to  program  the  proper  escpape  sequence  for  Alt  FI  thru  Alt  F6. 

1.  Type  <Alr>  <S>  within  emulator  mode  to  enter  SmarTerm  320  Setup  mode. 


2.  Use  arrow  keys  to  select  softkey  definitions  and  press  <ret>. 


3.  Use  the  following  definitions  provided  by  the  Ascent  manual  for  FI  I  thur  FI  6  to  define  the  keys: 


Ascent  Command 


F12 

F13 

F14 

F15 

FI6 


ST220 

<ESC><  ESC>  I 

<ESC><ESC>2 

<ESC><ESC>3 

<ESC><ESC>4 

<ESC><ESC>5 

<ESC><ESC>6 


4.  Press  <Esc>,  then  <s>  for  saving  softkey  definitions  to  the  selected  namedconfiguration. 


5.  Press  <Alt><s>  to  return  to  emulator  mode. 
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4.  PC  with  Windows'  Terminal  connected  to  IBM  3090 


3090  fTn3270I 

EC 

PFl 

^'roa 

PF2 

''fOr 

PF3 

^fOs 

PF4 

^rot 

PF5 

PF6 

'^rov 

PF7 

''fOw 

PF8 

/'rax 

PF9 

'^rov 

PFIO 

''fOP 

PFll 

^roQ 

EE12 _ 

_ 2[QK 

Note:  There  is  also  a  "bug"  where  the  Terminal  Emulation  changes  to  TTY  instead  of  locking  on  the  VTIOO 
mode.  Therefore  if  the  cursor  is  not  moving  upon  carriage  returns,  verify  the  Terminal  Emulation  is  VTIOO. 
Configure  Terminal  for:  VTIOO,  19200  baud,  com  I  no  stop,  no  parity,  no  flow-control  as  a  means  to 
communicate  through  the  Xyplex  terminal  server. 

Steps  for  programming  Function  Keys  for  Windows: 

1.  Open  a  Terminal  Application  and  name  the  file  "IBM.TRM"  for  example. 

2.  Choose  the  Function  Keys  under  the  Settings  menu. 

3.  Choose  a  Key  level;  There  are  4  levels  for  eight  keys  for  a  possible  32  Function  Keys  assigiunent. 

4.  Assign  a  name  to  the  Keyname  Box  and  a  corresponding  command  escape  sequence  on  the  Command 
Box. 

5.  Repeat  steps  3  and  4  to  fill  in  additional  function  keys. 

6.  Select  the  Keys  Visible  Check  box  for  visible  function  keys. 

7.  Upon  finishing,  select  the  OK  button. 

See  Figure  A  of  Appendix  for  Function  Keys  example. 
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5.  PC  with  Windows'  Terminal  connected  to  DEC  VAX 


YAX 

£C 

HELP  tPFl  01 

''fOPH 

''ffd- 

''fOP 

COLON  <ret> 

_ ^fOPn^'M 

LOGOUT 

PFl 

''fOP 

PF2 

''roo 

PF3 

''fOR 

PF4 

^ros 

Backspace 

''H 

Line  Insert 

ESCr<n^ 

FSC 

ESC 

Char  delete 

ESCr<n>P 

Char  width 

ESCr<n>trt) 

Cursor  reset 

ESC  8 

Erase  entire  line 

ESCf2K 

Nole:  Configure  the  Windows'  TERMINAL  Settings  as  follows:  VTIOO,  19200  baud,  com  I.  no  stop,  no 
parity,  no  flow-control  as  a  means  to  communicate  through  theXyplex  terminal  server.  Follow  the  same 
steps  for  programming  Function  Keys  for  Windows  on  the  previous  page. 
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6.  PC  with  Windows'  Terminal  connected  to  UNIX  host 


mix 

EC 

FI 

_ ESC  I 

F2 

_ ESC2 

F3 

_ ESC  3 

F4 

_ ESC4 

F5 

_ ESCl 

F6 

_ ESCi 

F7 

_ ESC! 

F8 

ESCl 

F9 

ESC  9 

FIO 

_ ESCO 

Fll 

_ ESC  ESC! 

F12 

_ ESC  ESC  2 

FH 

_ ESC  ESC  3 

F14 

ESC  ESC  4 

F15 

_ ESCESCi 

F16 

ESCESCLd 

ENTER 

_ ENTER 

Note:  Select  Windows  Terminal  Settings/Communications:  VT-1 00,  19200  baud,  no  stop,  no  parity,  no 
flow-control. 

The  above  keymap  appears  from  USS  after  it  identifies  the  remote  keyboard  to  be  Window's  Terminal 
VT10I(the  same  as  VTIOO)  keyboard.  This  keymap  applies  specifically  to  the  ASCENT2  application  on 
USS.MCCLELLAN.AF.MIL.  Follow  the  steps  in  the  previous  example  under  PC  with  Windows  connected  to 
IBM  2090  for  programming  Function  Keys. 


10 


APPENDIX  A 


Example  of  Function  Key  Display  for  PF1-PF8  (Key  Level  1)  in  Window'sTerminal. 
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APPENDIX  B: 


Installation  Procedures  for  SmartTerm  320  (Summary).  Refer  to  SMARTERM  320  Installation  for  detailed 
step-by-step  instructions. 

Software  and  Hardware  Requirements 
Persoft  Supplied 

SmarTerm  320  User  Manual 

SmarTerm  Diskettes  (thee  5.25  inch  diskettes  or  two  3.5  inch  diskettes) 

SmarTerm  320  Reference  Card 
License  Agreement 
Registration  Card 

IBM  PC  (or  compatible)  Equipment 

IBM  PC,  XT,  AT,  PS/2  (or  compatible)  with  512KB 
At  least  one  high  density  (5.25  inch  or  3.5  inch)  or  a  hard  disk 
Monitor  and  graphics  adapter  (if  you  plan  to  use  graphics) 

I/O  board  or  network  connection 
PC  DOS,  any  version  between  2.0  and  4.0 

On-site  Equipment 

Cable  from  PC  to  Xyplex  terminal  server  (consult  Xyplex  1600  Hardware  Installation  and 
Maintenance  Manual)  Note:  Xyplex  1600  Terminal  Server  is  DTE  and  a  PC  workstation 
is  DTE,  therefore  a  crossover  cable  is  necessary. 


Procedures: 

1.  Before  loading  the  installation  diskette  into  the  PC,  make  a  hardware  list  of  the  following: 

Graphics  Display  Adapter 
132  Column  Board  if  present: 

Network  system  (select  serial  port) 

Type  of  Keyboard  i.e.,  AT ,  Enhanced,  Enhanced  (non-standard),  PC/XT  Keyboard,  LK250 
Keyboard 

2.  Type  <install>  and  answer  the  set-up  questions  with  respect  to  hardware  equipment. 

3.  Use  the  Set-up  Mode  <ALT>  <s>  to  configure  one  selection  out  of  a  possible  eight. 

One  configuration  was  sufficient  since  key  mapping  to  the  various  types  of  hosts  (VAX,  IBM  and 
UNIX)  work  satisfactorily. 
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APPENDIX  B  (cont.): 


4.  The  following  parameters  were  used  on  the  test  configuration: 


Configuration  name: 

STANDARD 

Primary  phone  number 
Communication  parameters: 
Communication  line 

com  port  1 

baud  rate 

19200 

Maximum  trans.  rate 

Unlimited 

bits/character-parity 

8/none 

stop  bit 

1  bit 

auto  XON/XOFF 

64  chars 

Disconnect  on  exit 

yes 

disconnect  duration 

2  sec 

display  parity  error 

yes 

online/local 

on-line 

local  echo 

disable 

5.  Type  <s>  to  save  the  configuration 

6.  type  <ret>  to  return  to  the  set-up  menu 

7.  move  the  bar  cursor  to  configuration  "standard" ,  press  return  to  enter  emulator  mode 

8.  At  this  point,  you  should  see  a  prompt  from  the  Xyplex  terminal  server  (i.e.,  "S35520>  ") 

9.  Use  the  telnet  command  to  connect  to  the  host  (  i.e.,  telnet  uss.mcclellan.af.mil) 
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